OLA 文档中心

主题

2026-06-10

获取ROI区域 - GetROIRegion ​

函数简介 ​

获取图像中ROI（Region of Interest）区域的边界坐标信息。

接口名称 ​

GetROIRegion

DLL调用 ​

int GetROIRegion(long instance, long ptr, int* x1, int* y1, int* x2, int* y2);

参数说明 ​

参数名类型说明
instance长整数型OLAPlug对象的指针，由 CreateCOLAPlugInterFace 接口生成。
ptr长整数型图像指针
x1整数型指针输出参数，ROI区域左上角X坐标
y1整数型指针输出参数，ROI区域左上角Y坐标
x2整数型指针输出参数，ROI区域右下角X坐标
y2整数型指针输出参数，ROI区域右下角Y坐标

示例 ​

SDK 调用 ​

cpp
#include "OLAPlugServer.h"

OLAPlugServer ola;
long imgPtr = ola.LoadImage("images/scene.png");
if (imgPtr != 0) {
    int32_t x1 = 0, y1 = 0, x2 = 0, y2 = 0;
    if (ola.GetROIRegion(imgPtr, &x1, &y1, &x2, &y2) == 1) {
    }
    // 后续不再使用该图时释放
    ola.FreeImage(imgPtr);
}
csharp
using OLAPlug;

var ola = new OLAPlugServer();
long imgPtr = ola.LoadImage("images/scene.png");
if (imgPtr != 0)
{
    if (ola.GetROIRegion(imgPtr, out int x1, out int y1, out int x2, out int y2) == 1)
    {
        // x1, y1, x2, y2
    }
    // 后续不再使用该图时释放
    ola.FreeImage(imgPtr);
}
python
from OLAPlugServer import OLAPlugServer

ola = OLAPlugServer()
img_ptr = ola.LoadImage("images/scene.png")
if img_ptr:
    ret, x1, y1, x2, y2 = ola.GetROIRegion(img_ptr)
    if ret == 1:
        pass
    # 后续不再使用该图时释放
    ola.FreeImage(img_ptr)
java
import com.olaplug.OLAPlugServer;
import com.olaplug.model.ApiResult;
import com.olaplug.model.Point;
import com.olaplug.model.Size;
import com.olaplug.model.Rect;
import java.util.List;

OLAPlugServer ola = new OLAPlugServer();
long imgPtr = ola.LoadImage("images/scene.png");
if (imgPtr != 0) {
    ApiResult<Rect> roi = ola.GetROIRegion(imgPtr);
    if (roi != null && roi.success) {
        int x1 = roi.data.X1;
    }
    // 后续不再使用该图时释放
    ola.FreeImage(imgPtr);
}
cpp
var ola = com("OlaPlug.OlaSoft")
var imgPtr = ola.LoadImage("images/scene.png")
if(imgPtr) {
    var ret = ola.GetROIRegion(imgPtr)
    // 后续不再使用该图时释放
    ola.FreeImage(imgPtr)
}
vbscript
Set ola = CreateObject("OlaPlug.OlaSoft")
imgPtr = ola.LoadImage("images/scene.png")
If imgPtr <> 0 Then
    ret = ola.GetROIRegion(imgPtr)
    ' 后续不再使用该图时释放
    ola.FreeImage(imgPtr)
End If
text
.局部变量 ola, OLAPlug
ola.创建 ()
imgPtr ＝ ola.LoadImage ("images/scene.png")
.如果真 (imgPtr ≠ 0)
    ret ＝ ola.GetROIRegion (imgPtr)
    ' 后续不再使用该图时释放
    ola.FreeImage (imgPtr)
.如果真结束
aardio
import OLAPlugServer;
var ola = OLAPlugServer();
var imgPtr = ola.LoadImage("images/scene.png");
if(imgPtr){
    var ret = ola.GetROIRegion(imgPtr);
    // 后续不再使用该图时释放
    ola.FreeImage(imgPtr);
}
text
变量 ola <类型 = OLAPlugServer>
ola = 新建 OLAPlugServer
长整数 imgPtr = ola.LoadImage("images/scene.png")
如果真 (imgPtr ≠ 0)
{
    整数 ret = ola.GetROIRegion(imgPtr)
    ' 后续不再使用该图时释放
    ola.FreeImage(imgPtr)
}
cpp
#include "OLAPlugServer.h"

OLAPlugServer ola;
long imgPtr = ola.LoadImage("images/scene.png");
if (imgPtr != 0) {
    int32_t x1 = 0, y1 = 0, x2 = 0, y2 = 0;
    if (ola.GetROIRegion(imgPtr, &x1, &y1, &x2, &y2) == 1) {
    }
    // 后续不再使用该图时释放
    ola.FreeImage(imgPtr);
}

原生 DLL 调用 ​

cpp
long instance = CreateCOLAPlugInterFace();
int x1 = 0, y1 = 0, x2 = 0, y2 = 0;
GetROIRegion(instance, imgPtr, &x1, &y1, &x2, &y2);
csharp
using System.Runtime.InteropServices;

[DllImport("OLAPlug_x64.dll", CallingConvention = CallingConvention.StdCall)]
static extern long CreateCOLAPlugInterFace();
[DllImport("OLAPlug_x64.dll", CallingConvention = CallingConvention.StdCall)]
static extern int GetROIRegion(long ola, long ptr, out int x1, out int y1, out int x2, out int y2);

long instance = CreateCOLAPlugInterFace();
GetROIRegion(instance, imgPtr, out int x1, out int y1, out int x2, out int y2);
python
from ctypes import CDLL, c_int, c_int64, byref, create_string_buffer

ola = CDLL("OLAPlug_x64.dll")
ola.CreateCOLAPlugInterFace.restype = c_int64
instance = ola.CreateCOLAPlugInterFace()
# imgPtr 为图像句柄

返回值 ​

整数型：1 成功，0 失败。

注意事项 ​

  • 通常与 FastROI 函数配合使用。
  • ROI区域大小计算为 (x2-x1) x (y2-y1)。